home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / macade.zip / ALTL.DOC next >
Text File  |  1991-12-07  |  12KB  |  237 lines
  1.                              ALTL.wpm
  2.             A Macro Menuing System for WordPerfect 5.1 
  3.  
  4.                                 by
  5.  
  6.                       Jeffrey S. Kane, Ph.D.
  7.                 Performance Sciences International
  8.                           Summerfield, NC
  9.  
  10.  
  11. 1.   Read the REGISTER.doc, LICENSE.doc, and WARRANTY.doc files distributed
  12.      with this macro.
  13.  
  14. 2.   Requires:
  15.           WordPerfect 5.1. We have one unconfirmed report that AltL may have
  16.           some troubles with releases of 5.1 dated prior to 12/31/90, but
  17.           this may be unfounded.  If you find it doesn't work on an earlier
  18.           release, this will be another good reason for you to request an
  19.           update.
  20.  
  21. 3.   Features:
  22.  
  23.      A.   Each menu can list the names and descriptions of 40
  24.           macros.
  25.  
  26.      B.   Names and descriptions listed side-by-side; no additional
  27.           strokes to get descriptions.
  28.  
  29.      C.   Expanded macro descriptions (64 versus 39 characters)
  30.           which are instantly editable.
  31.  
  32.      D.   Any macro in a menu can be executed from the menu by
  33.           scrolling the highlight bar down to its name and pressing
  34.           [ENTER].
  35.  
  36.      E.   Any macro in a menu can be deleted from the menu.
  37.  
  38.      F.   A new macro name and description can be entered on any of
  39.           the menu's 40 lines.
  40.  
  41.      G.   Duplicating AltL.wpm under different names, making
  42.           corresponding changes to fresh and renamed copies of the
  43.           TableX.wpm and Macromnu.X files, and reflecting those
  44.           changes in the header portion of the renamed AltL.wpm
  45.           copies, allows the creation and use of specialized macro
  46.           menus.  For example, you might create a menu of all the
  47.           macros you use in producing a newsletter, another for
  48.           those in preparing annual reports, another for those used
  49.           in preparing articles in a particular format required by
  50.           a journal, etc.
  51.  
  52. 4.   Installation:
  53.  
  54.      A.   AltL.wpm requires the following files to be present in
  55.           the directory in which your macros reside:
  56.                      AltL.wpm
  57.                      Table1.wpm
  58.                      Macromnu.1
  59.              Modtable.exe   (users don't use this file
  60.                     directly but it must be present
  61.                                     for AltL.wpm to work properly)
  62.  
  63.       Be sure to keep copies of the original unused versions of
  64.           these files in case you want to set up additional menus
  65.           or in the event you have to re-install AltL.
  66.  
  67.      B.   The highlight bar in the AltL menu utilizes the color
  68.           attributes assigned to the UNDERLINE feature.  If you
  69.           don't feel that the representation of UNDERLINE is set to
  70.           allow highlighted menu items to stand out sufficiently,
  71.           change the color attributes assigned to UNDERLINE by
  72.           accessing Setup--Display--Colors/Fonts/Attributes--Screen
  73.           Colors (Shift-F1  2  1  1) in WordPerfect.
  74.  
  75.      C.   Edit the AltL.wpm file in the macro editor (Ctrl-F10 
  76.           AltL  2).  Change the header information according to
  77.           the instruction comments at the top of the file. 
  78.           Specifically,...
  79.                1)    Change the directory assigned to WPMDir to the
  80.                      one holding the WordPerfect macro files in
  81.                      your system if 'C:\WP51\MACROS\' is not correct.
  82.                2)    Change the name of the file assigned to
  83.                      MacroFil if you do not wish to use the name
  84.                      "Macromnu.1" for this purpose.  (Be sure to
  85.                      change the file's name also in this case.)
  86.                3)    Change the name of the file assigned to
  87.                      MacTable if you do not wish to use the name
  88.                      "Table1.wpm" for this purpose.  (Be sure to
  89.                      change the file's name also in this case.)
  90.                4)    Change the value assigned to OldSpeed from
  91.                      "Normal" to one of the other values specified
  92.                      in the comment if you wish the macro to
  93.                      restore the keyboard to some cps speed besides
  94.                      "Normal" at the conclusion of the macro.
  95.                5)    Do NOT change the values assigned to any other
  96.                      variables.
  97.  
  98.      D.   Enter WordPerfect and retrieve the Macromnu.1 file.  At
  99.           the top of the document activate Reveal Codes (Alt-F3)
  100.           and notice that the font selected is *Courier 10 cpi. 
  101.           This is a fixed space font within the basic HPLaserJet
  102.           Series II font list.  It should work okay regardless of
  103.           whether you're using this printer or not since this file
  104.           is used only for display purposes, and not meant to be
  105.           printed out.  However, if some problem arises (e.g.,
  106.           lines not all the same length, or some lines wrapping to
  107.           second line), or if you wish to print the file out,
  108.           change the printer selection to one available on your
  109.           system and be sure a 12 point (10 cpi) fixed space font
  110.           is selected as the base font (Ctrl-F8  4).
  111.  
  112.      E.   Upon your initial execution of AltL (accomplished by
  113.           merely holding down the ALT key and pressing L, of
  114.           course), you"ll see that all the menu entries are specified
  115.           as "*Not in Use".  You can now add any of your macros by
  116.           merely scrolling to the line on which you want the entry
  117.           for a macro to appear and pressing the [INSERT] key.  You
  118.           will then be prompted for the macro's name and
  119.           description.  Pressing [ENTER] after typing in the
  120.           description (you can leave the description blank if you
  121.           so wish) sends the system into a brief spasm while the
  122.           .wpm are externally altered and you are then returned to
  123.           the now revised menu.
  124.  
  125. 5.   Operation:
  126.  
  127.      A.   Add or modify any macro entries in the menu by repeating
  128.           the procedure described in 4D above for the initial
  129.           insertion of macro entries.
  130.  
  131.      B.   Delete macro entries from the menu by moving the
  132.           highlight bar down to the target entry and pressing the
  133.           [DELETE] key.  You'll be prompted with "Are you
  134.           sure...(Y/N)?" and the deletion will then proceed or be
  135.           canceled depending on your response.
  136.  
  137.      C.   Most Importantly, you can execute a macro by moving the
  138.           highlight bar to its menu entry and pressing [ENTER]. 
  139.           The macro will execute at the place in your document from
  140.           which you invoked the macro menu unless you have added
  141.           the {NEST}MOVECSR~ macro command as the first line of the
  142.           macro to be executed.  This command invokes the
  143.       MOVECSR.wpm macro, also supplied as part of the MacroAde
  144.           package, which allows you to move the cursor anywhere in
  145.           your document before the macro of primary interest is
  146.           executed.
  147.  
  148.      D.   You'll note that the movement of the highlight bar via
  149.           the up and down cursor keys is rather slow.  This was
  150.           unavoidable because the WordPerfect program apparently
  151.           does not clear the keyboard buffer between keyboard
  152.           entries occurring within macros.  Consequently, a
  153.           keyboard buffer clearing routines written in the macro
  154.           language had to be added to prevent the scroll bar from
  155.           running out of synchronization with the macro's line
  156.           counter.  A side effect of the buffer clearing routine is
  157.           to slow down the highlight bar section.  This can be
  158.           partially compensated for by using the PgUp and PgDn
  159.           keys, which actually just move you one screen (24 lines)
  160.           at a time, but quickly.
  161.  
  162.      E.   The program strives, and to the best of my knowledge
  163.           succeeds, at returning your system in the same state it
  164.           was in when AltL was invoked.  It also will return you to
  165.           the place in your document at which it was invoked unless
  166.           you use MOVECSR.wpm.  Note that in some cases, due to the
  167.           continuing quirks of WordPerfect, the line to which it
  168.           returns, or the following one, may be knocked slightly
  169.           out of format.  This happens infrequently and the
  170.           readjustment of the line is always just a matter of 1 or
  171.           2 keystrokes.
  172.  
  173. 6.   Setting Up Additional Menus:
  174.  
  175.           You can set up as many different AltL-type menus as you
  176.      wish.  Each such menu would be invoked by a different name,
  177.      preferably by an ALT plus letter combination for ease of
  178.      execution.  Here is the procedure for setting up each such
  179.      additional menu.
  180.  
  181.      A.   Decide on the names you want to assign to the main
  182.           menuing macro (AltL.wpm) in the new menu to be set up. 
  183.           Also decide on the numbers to be used in the new names
  184.           for Table1.wpm and Macromnu.1 that will be used in the
  185.           new menu.  I recommend just using the next unused number.
  186.  
  187.      B.   Copy fresh copies of the following files from your
  188.           archive disk or directory to the new names you have
  189.           selected in the directory where your macros reside.  BE
  190.           ABSOLUTELY CERTAIN TO COPY THE FILES TO THEIR SPECIFIC
  191.           NEW NAMES OR ELSE YOU WILL OVERWRITE THE VERSIONS YOU'VE
  192.           PREVIOUSLY SET UP.
  193.  
  194.                Copy  AltL.wpm  C:\WP51\MACROS\NewAltName.wpm
  195.                Copy  Table1.wpm  C:\WP51\MACROS\Table#.wpm
  196.                Copy  Macromnu.1  C:\WP51\MACROS\Macromnu.#
  197.  
  198.      C.   Edit the new Alt?.wpm (formerly AltL.wpm) file in the
  199.           macro editor (Ctrl-F10  Alt?  2).  Change the header
  200.           information according to the instruction comments at the
  201.           top of the file.
  202.                1)    Change the directory assigned to WPMDir to the
  203.                      one holding the WordPerfect macro files in
  204.                      your system if "C:\WP51\MACROS\" is not correct.
  205.                2)    Change the name of the file assigned MacroFil
  206.                      to the new file name you've assigned to
  207.                      Macromnu.1 in Step A, above (i.e., to
  208.                      Macromnu.?, where ?=the new total number of
  209.                      menus you'll have).
  210.                3)    Change the name of the file assigned to
  211.                      MacTable to the new file name you've assigned
  212.                      to Table1.wpm in Step A, above (i.e., to
  213.                      Table?.wpm, where ?=the new total number of
  214.                      menus you'll have).
  215.                4)    Change the value assigned to OldSpeed from
  216.                      "Normal" to one of the other values expressing
  217.                      the cps level at which you run your keyboard
  218.                      outside of this menuing system.
  219.  
  220.      D.   With these steps accomplished you are now ready to invoke
  221.           the new menu and insert the entries you want it to
  222.           contain, as described previously in the installation
  223.           section.
  224.  
  225. 7.   Technical support:
  226.  
  227.       Free technical support will be furnished to any licensed users
  228.      who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
  229.      (Eastern) at the following number:  (919) 643-3492
  230.  
  231.      We may also be reached by mail at:
  232.  
  233.      Performance Sciences International
  234.      Suite 1250
  235.      3001 Latta Drive
  236.      Summerfield, NC  27358
  237.